-
Notifications
You must be signed in to change notification settings - Fork 936
Have vs code markdownlint extension use config file #4755
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Have vs code markdownlint extension use config file #4755
Conversation
| @@ -0,0 +1,5 @@ | |||
| { | |||
| "recommendations": [ | |||
| "davidanson.vscode-markdownlint" | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like the idea, but looks like this extension is based on markdownlint-cli2, and so flags a lot of things that our existing configuration (based on older version) doesn't
I'd suggest updating the repo to markdownlint-cli2 first and updating configuration to match current repo practices and then come back to this
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I took a look at this and it appears that the first issue is that markdownlint-cli has not been updated.
It is however now pending in the Dashboard #4507
The marketplace listing mentions it supports both. I have also confirmed that is the case. I will submit seperate PR to update rules which will enable update to be merged.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pr which applies the latest linting rules is ready as #4756 in that pr when I disabled a rule the violations updated in vs code.
|
This PR was marked stale due to lack of activity. It will be closed in 7 days. |
## Changes This runs the latest markdownlint-cli and resolves the issues which arises. The dependency update will occur via renovate. This explains @trask feedback in #4755 I have tried to keep changing the style to a minimum hence if all aligned except final column, layout renames as such. For non-trivial changes, follow the [change proposal process](https://github.com/open-telemetry/opentelemetry-specification/blob/main/CONTRIBUTING.md#proposing-a-change). * [ ] Related issues # * [ ] Related [OTEP(s)](https://github.com/open-telemetry/oteps) # * [ ] Links to the prototypes (when adding or changing features) * [ ] [`CHANGELOG.md`](https://github.com/open-telemetry/opentelemetry-specification/blob/main/CHANGELOG.md) file updated for non-trivial changes * [ ] [Spec compliance matrix](https://github.com/open-telemetry/opentelemetry-specification/blob/main/spec-compliance-matrix/template.yaml) updated if necessary
Changes
This cleans up the vscode settings to use the markdownlint config file and recomended that users install the extension.
Also remove un-used settings.
For non-trivial changes, follow the change proposal process.
CHANGELOG.mdfile updated for non-trivial changesspec-compliance-matrix.mdupdated if necessary